PATHMac OS 8 Developer Documentation > Operating System Services > Multiprocessing Services >

Adding Multitasking Capability to Applications Using Multiprocessing Services

   

Changes From Previous Versions of Multiprocessing Services

Multiprocessing Services 2.0 supports some, but not all, functions available in earlier releases. Table B-1 lists the functions that were introduced in version 1.0 that are still supported in version 2.0.

Table B-1   Older functions supported in version 2.0 

Name

Comments

MPProcessors
MPCreateTask
MPTerminateTask
MPCurrentTaskID
MPYield
MPExit
MPCreateQueue
MPDeleteQueue
MPNotifyQueue
MPWaitOnQueue
MPCreateSemaphore
MPCreateBinarySemaphore In C, a macro that calls MPCreateSemaphore .
MPDeleteSemaphore
MPSignalSemaphore
MPWaitOnSemaphore
MPCreateCriticalRegion
MPDeleteCriticalRegion
MPEnterCriticalRegion
MPExitCriticalRegion
MPAllocate Deprecated. Use MPAllocateAligned instead.
MPFree
MPBlockCopy
MPLibraryIsLoaded In C, a macro that checks to see if the MPProcessors symbol is resolved.

Table B-2 lists Multiprocessing Services functions that are new in version 2.0.

Table B-2   New functions introduced with version 2.0 

Name

Comments

MPProcessorsScheduled
MPSetTaskWeight
MPTaskIsPreemptive
MPAllocateTaskStorageIndex
MPDeallocateTaskStorageIndex
MPSetTaskStorageValue
MPGetTaskStorageValue
MPSetQueueReserve
MPCreateEvent
MPDeleteEvent
MPSetEvent
MPWaitForEvent
UpTime
DurationToAbsolute
AbsoluteToDuration
MPDelayUntil
MPCreateTimer
MPDeleteTimer
MPSetTimerNotify
MPArmTimer
MPCancelTimer
MPSetExceptionHandler
MPThrowException
MPDisposeTaskException
MPExtractTaskState
MPSetTaskState
MPRegisterDebugger
MPRegisterDebugger
MPAllocateAligned Preferred over MPAllocate.
MPGetAllocatedBlockSize
MPBlockClear
MPDataToCode
MPRemoteCall Preferred over _MPRPC

Table B-3 shows unofficial functions included in earlier header files that remain supported in version 2.0. Note, however, that future versions may not support these functions.

Table B-3   Unofficial functions still supported in version 2.0

Name

Comments

_MPRPC Deprecated. Use MPRemoteCall instead.
_MPAllocateSys Deprecated. Use MPAllocateAligned instead.
_MPTaskIsToolboxSafe
_MPLibraryVersion
_MPLibraryIsCompatible

Table B-4 shows functions used for debugging that are no longer supported in version 2.0. You can access these functions for older builds if you #define MPIncludeDefunctServices to be nonzero.

Table B-4   Debugging functions unsupported in version 2.0

Name

Comments

_MPInitializePrintf
_MPPrintf
_MPDebugStr
_MPStatusPString
_MPStatusCString


© 1999 Apple Computer, Inc. – (Last Updated 07 May 99)